---
title: Vertex AI Claude
description: Learn how to use Vertex AI Claude models with Agno.
sidebarTitle: Claude
---

Use Claude models through Vertex AI. This provides a native Claude integration optimized for Vertex AI infrastructure.

We recommend experimenting to find the best-suited model for your use-case. Here are some general recommendations:

- `claude-sonnet-4@20250514` model is good for most use-cases.
- `claude-opus-4@20250805` model is their best model.

## Authentication

Set your `GOOGLE_CLOUD_PROJECT` and `CLOUD_ML_REGION` environment variables.

<CodeGroup>

```bash Mac
export GOOGLE_CLOUD_PROJECT=***
export CLOUD_ML_REGION=***
```

```bash Windows
setx GOOGLE_CLOUD_PROJECT ***
setx CLOUD_ML_REGION ***
```

</CodeGroup>

And then authenticate your CLI session:

```bash
gcloud auth application-default login
```

## Example

Use `Claude` with your `Agent`:

<CodeGroup>

```python agent.py
from agno.agent import Agent
from agno.models.vertexai.claude import Claude

agent = Agent(
    model=Claude(id="claude-sonnet-4@20250514"),
)

# Print the response on the terminal
agent.print_response("Share a 2 sentence dramatic story.")
```

</CodeGroup>

<Note>View more examples [here](/examples/models/vertexai/claude/basic). </Note>

## Parameters

| Parameter    | Type  | Default                      | Description                                        |
| ------------ | ----- | ---------------------------- | -------------------------------------------------- |
| `id`         | `str` | `"claude-sonnet-4@20250514"` | The specific Vertex AI Claude model ID to use      |
| `name`       | `str` | `"Claude"`                   | The name identifier for the Vertex AI Claude model |
| `provider`   | `str` | `"VertexAI"`                 | The provider of the model                          |
| `region`     | `str` | `"None`                      | The region to use for the model                    |
| `project_id` | `str` | `None`                       | The project ID to use for the model                |
| `base_url`   | `str` | `None`                       | The base URL to use for the model                  |

`Claude` (Vertex AI) extends the [Anthropic Claude](/concepts/models/anthropic) model with Vertex AI integration and has access to most of the same parameters.
